home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / jam / jamdisk4 / arpuserdocs3.1 / readme < prev    next >
Text File  |  1995-03-18  |  6KB  |  136 lines
  1. *** ARPDOC3.ZOO ******************************************************
  2. Copyright (c) 1987,88,89 by ARP Authors.
  3. All Rights Reserved.
  4.  
  5. This file contains documentation for the V1.3 ARP commands.  ARP, the
  6. AmigaDOS Resource Project, is a group effort to provide enhancements to
  7. AmigaDOS for users, as well providing a resource for Amiga developers
  8. and Commodore to help improve the Amiga's OS software.
  9.  
  10. This file, ARPDOC3.ZOO is freely redistributable *PROVIDED IT IS
  11. DISTRIBUTED IN IT's ORIGINAL UNMODIFIED FORM*.  Please do not make
  12. any changes to any files which you pass on to others; the user's
  13. only insurance that they have the officially supported version of the
  14. ARP release is in getting the files exactly as released.  For further
  15. information about distribution and support of ARP,  please read the
  16. file "DISCLAIMER", which is included with this distribution.
  17.  
  18. **********************************************************************
  19.  
  20. The ARP commands are a set of CLI programs designed to compatibly
  21. replace the Commodore V1.3 versions of most of the commands in the "C:"
  22. directory of the WorkBench diskette; in addition there are several
  23. extra programs and an ARP Shell in the V1.3 ARP release.  The ARP
  24. release file is called "ARPREL3.ZOO", and it includes information about
  25. installing ARP and documentation for the ARP Shell. This distribution,
  26. "ARPDOC3.ZOO", contains documentation for each individual command
  27. program that is included in ARPREL3.ZOO; each command is documented in
  28. a file named the same as the respective command program.
  29.  
  30. The remainder of this README file is a list of bugs, gotchas, and
  31. incompatabilities which have been found since the release of
  32. ARPREL3.ZOO; this buglist corresponds to "ARP V1.3.0".  The first
  33. group of bugs are set off from the rest as being more critical,
  34. while the second group describes minor bugs and incompatabilies which
  35. may show up.  If you wish to be most conservative, you may wish
  36. to retain the Commodore versions of the commands MOUNT, EXECUTE,
  37. and RUN rather than using the V1.3.0 ARP versions of these
  38. commands.
  39. *******    More Serious ARP V1.3.0 Bugs    ******************************
  40.  
  41. MOUNT    If you have a Mountlist entry which includes a "MASK=nnnnn"
  42.     statement, you must insure that the value specified is an
  43.     EVEN number.  You probably will not have any mountlist entries
  44.     with a "MASK=" statement unless you have a RONIN 68020 CPU
  45.     board with memory outside the normal address space of the
  46.     Amiga.  For example, if you have a mountlist entry which
  47.     includes the statement "MASK=X7FFFFF" that statement should
  48.     be edited to be "MASK=X7FFFFE" instead.  If you do not make
  49.     this change, you may experience problems when attempting to
  50.     run backup programs, among other possible effects.
  51.  
  52.     In order to reboot Commodore's RAD: device, you must add a
  53.     statement "BOOTPRI=0" to the mountlist entry for RAD:.
  54.  
  55.     The ARP Mount will not return a WARN level for already-mounted
  56.     devices, which may require a change to some script files.  You
  57.     can use the "ASSIGN EXISTS" statement instead for this purpose.
  58.  
  59. EXECUTE    There are some problems in expanding .key values with the
  60.     ARP V1.3.0 version of Execute, both in the builtin Execute
  61.     provided with ASH and in the standalone "Execute" program.
  62.  
  63. RUN    There are some unverified potential problems using the ARP
  64.     V1.3.0 RUN command in some system configurations.
  65. ******* Less Serious ARP V1.3.0 Bugs and Gotchas  ********************
  66.  
  67. ASH    If you attempt to expand an environment variable in ASH
  68.     (The ARP Shell) which is not defined, you will get a
  69.     garbage value.  Also in ASH, there is no way to get a "$"
  70.     character as part of the prompt, except by expansion of an
  71.     environment variable.
  72.  
  73. ASSIGN    There is an unverified report that the Assign multi-args
  74.     capability does not work in a system which has only 512K
  75.     bytes of RAM:.
  76.  
  77. COPY    The COPY command should not be used with Commodore's PIPE:
  78.     device, as it will truncate files to a maximum of 4K bytes.
  79.  
  80. DIR    If you use the DIR interactive capability, and TYPE a file from
  81.     within DIR, then you will not be able to DELETE that file in
  82.     that interactive session but rather will have to return to CLI
  83.     to delete the file.
  84.  
  85. EVAL    The ARP V1.3.0 Eval command does not support character constant
  86.     values, such as "'c'".
  87.  
  88. LIST    If you have files with an invalid datestamp, those files will
  89.     not be displayed by LIST.  You can correct these files using
  90.     the SETDATE command.
  91.  
  92. PROTECT    With the ARP V1.3.0 PROTECT command, the keywords "ADD" and
  93.     "SUB" are treated as KEY values rather than as SWITCH values,
  94.     which means the keyword must preceed the protect bits to ADD.
  95.     With the Commodore PROTECT, the position on the command line
  96.     for these keywords does not matter.  This may impact some
  97.     EXECUTE scripts for installing software.
  98.  
  99. SKIP    The ARP V1.3.0 SKIP command will only "see" LAB statements in
  100.     a script file which are not indented in the script file.  There
  101.     must be no whitespace preceeding the "LAB" statement, unlike
  102.     the Commodore SKIP which allows leading whitespace.
  103.  
  104. TYPE    With the ARP TYPE command, you must explicitly specify the
  105.     keyword "TO" if you want to specify a destination file.  This
  106.     is because the ARP TYPE allows you to specify more than one
  107.     input file on the command line; the Commodore TYPE only allows
  108.     one input file, and thus if a second file is specified it is
  109.     automatically assumed to be the destination file in the
  110.     Commodore TYPE.
  111.  
  112. VERSION    You should not attempt to run the ARP V1.3.0 VERSION program
  113.     with an input file that is not a library or device driver.  The
  114.     ARP VERSION will attempt to load that device, and due to a bug
  115.     in the Amiga's Exec this can cause a GURU if the file is not
  116.     a valid device driver.  This problem is sidestepped in the
  117.     Commodore VERSION command by only attempting to load commands
  118.     which have an explicit ".device" or ".library" extension.
  119.  
  120. WHICH    The RES and NOTRES keywords are reversed in meaning in the
  121.     V1.3.0 release of ARP.  Also, the Commodore WHICH uses the
  122.     keyword "NORES" rather than "NOTRES".
  123.  
  124. **********************************************************************
  125. Editor note:  Individual document pages for each ARP command  are
  126.           in this mantained in this directory.  To see the list type:
  127.     
  128.         dir arpuserdocs1.3
  129.  
  130.  
  131.           Individual commands can then be printed or viewed.
  132.  
  133.  
  134.  
  135.               
  136.